| Ae TIMEOUT MACROTOOLS II 
Copyright © 1988 by Randy Brandt 


consultant, I have received many calls from 
UltraMacros users with requests for more 
ready-to-use macros to enhance the 
UltraMacros program. I have taken those 
requests to heart, and compiled the most 
powerful, efficient, and time-saving 
enhancements I could develop. It is hard to 
say what the MacroTools I applications 
have, in a nutshell. With over 250k of ' 
sample macros on a double-sided disk, they 
are indispensable to both the beginning 
programmer and the sophisticated user. 


MacroTools II is a must for serious macro 


users.” 
-Randy Brandt 


Major Features Include: 


ULTRA PUBLISHER: A unique combination of a 
TimeOut application and an UltraMacros Task File that 
makes it fast and easy to convert Word Processor files 
to two or three columns of text. Perfect for newsletters, 


brochures and reports! 


ADVANCED MAIL MERGE: A special macro 
set that simplifies mail merge techniques. It allows the 
use of the clipboard while you work, plus it scans your 
file and converts the replacement symbols to the correct 


mail merge codes. 


TimeOut MacroTools II is a trademark of Beagle Bros, Inc. Apple is a registered trademark of Apple 


Computer, Inc. AppleWorks is a registered trademark licensed to Claris Corp. 


BEAGLE BROS, INC. 


6215 Ferris Square, Suite 100 ¢« San Diego, CA 92121 
(619) 452-5500 
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Copyright © 1988 Beagle Bros, Inc. 


This manual and the software described in it are copyrighted with all 
rights reserved. Under the copyright laws, this manual or the software 
may not be copied, in whole or part, without written consent of Beagle 
Bros, except in the normal use of the software or to make a backup copy 
of the software. This exception does not allow copies to be made for 
others, whether or not sold, but all of the material purchased (with all 
backup copies) may be sold, given or loaned (but not rented) to another 
person. Under the law, copying includes translating into another 
language or format. You may use the software on any computer owned 
by you, but extra copies cannot be made for this purpose. 


LIMITED WARRANTY ON MEDIA AND REPLACEMENT 

If you discover physical defects in the manuals distributed with a 
Beagle Bros product or in the media on which a software product is 
distributed, Beagle Bros will replace the media or manuals at no charge 
to you, provided you return the item to be replaced with proof of 
purchase to Beagle Bros during the 90-day period after you purchased 
the software. 


All implied warranties on the media and manuals, including implied 
warranties of merchantability and fitness for a particular purpose, are 
limited in duration to ninety (90) days from the date of the original 
retail purchase of this product. 


Even though Beagle Bros has tested the software and reviewed the 
documentation, Beagle Bros makes no warranty or representation, 
either express or implied, with respect to software, its quality, perform- 
ance, merchantability, or fitness for a particular purpose. As a result, 
this software is sold "as is," and you the purchaser are assuming the 
entire risk as to its quality and performance. 


In no event will Beagle Bros be liable for direct, indirect, special, 
incidental, or consequential damages resulting from any defect in the 
software or its documentation, even if advised of the possibility of such 
damages. In particular, Beagle Bros shall have no liability for any 
programs or data stored in or used with Beagle Bros products, includ- 
ing the costs of recovering such programs or data. 


Some states do not allow the exclusion or limitation of implied warran- 
ties or liability for incidental or consequential damages, so the above 
limitation or exclusion may not apply to you. This warranty gives you 
specific legal rights, and you may also have other rights which vary 
from state to state. 


Welcome to TimeOut MacroTools Il 
TimeOut MacroTools II is a collection of sample macros and 
applications for use with TimeOut UltraMacros. If you don’t 
have UltraMacros, this disk is about as useful as a CP/M file 
utility. 


We Need Your Suppor 

MacroTools II is not copy-protected, and may be freely copied 
for your own use. However, it is copyrighted, so copies cannot 
be legally given away or sold. If a friend is interested in the 
macros and applications, they can order it just like you (hope- 
fully) did. By supporting us in this manner, you not only keep 
the law and feel good about yourself, you also encourage us to 
continue developing low-cost software to meet your computing 
needs. 


Installation 


You must already have a copy of AppleWorks with UltraMacros 
installed. If your version of TimeOut UltraMacros is less than 
v2.3, select the “Update UltraMacros” option from the Macro- 
Tools II startup menu. 


The update option will convert your UltraMacros disk to v 2.3. 
Please note: THE ULTRAMACROS INSTALLATION PRO- 
GRAM WILL NOT REFLECT THE NEW VERSION NUMBER, 
BUT THE FILES WILL HAVE BEEN CHANGED! When you 
boot AppleWorks, the version number selection on Macro 
Options will show v 2.3. 


Add the “Notes” file from this disk to your AppleWorks Desk- 
top and read it to learn more about the new commands. Make 
sure that you then install UltraMacros v2.3 on your AppleWorks 
startup disk. The new versions of MACRO COMPILER and 
MACRO OPTIONS must be used as well, so don’t forget to put 
them in your applications directory. 


New TimeOut Applications 

Copy the TO.FILELISTER, TO.PUB.HELP, TO.PUB.MENU, 
TO.ULTRA.LOCK and TO.UM.REF files to your TimeOut 
applications disk. Use TimeOut FileMaster, or any other copy 
program you might own. Be sure to use the "File Copy" and not 
"Disk Copy" option. You are now ready to discover the power of 
MacroTools II. 


File Lister 
This TimeOut application/macro combo allows your macros to 
provide users with a file list from which they can choose files. 


Load the macro file “FileList.Macro” for instructions on how to 
use FileLister. 


Ultra Lock 


UltraLock allows you to lock a macro set so that it can’t be listed 
using the Macro Compiler. Be careful, because locked files 
CANNOT BE UNLOCKED! 


UM Reference 


This is a handy pop-up reference chart which lists the various 
UltraMacros commands which can be used in your macros. 


Publish Help & Publish Menu 


These applications are for use with UltraPublisher by Mark 
Munz. Read the UltraPublisher documentation which follows. 


Handy Reference 


Load the Data Base file “MacroToolsFiles” for a quick reference 
to the various macro files on this disk. 


The sample macro files are found on both sides of this disk. 
Peruse them at your leisure. The best way to learn new program- 
ming skills is by examining and modifying existing programs. 
Experiment! All macro files have some documentation included. 


We recommend that you go through each file looking for new 
ideas and techniques. Hopefully many of the macros themselves 
will be useful as well. 


Ultra Publisher 


by Mark Munz 


Ultra Publisher is a unique combination of TimeOut applications 
and an UltraMacros Task File that makes it easy to convert Word 
Processor files into two or three column documents. 


Getting Started 

First of all make sure that the PUBLISH system file is in your 
AppleWorks directory, and that TO.PUB.HELP and 
TO.PUB.MENU are in your TimeOut directory. Start Apple- 
Works and add the desired files to the Desktop. 


There are two ways to get Ultra Publisher running: 
Launch the “PUBLISH” system file from inside of 
AppleWorks using Macro Options or Task Launcher 
(from MacroTools J). 

-OR- 


Load and compile “Ultra Pub v1.0” and press 
Solid Apple-]. 


You will be presented with the Publish Menu. 


Publish Menu 
This application is used by the Ultra Publisher (UP) task file to 
determine how you wish to format your Document. 


Options : 
Justified /Unjustified Text 


If you decide you want JUSTIFIED text transfers, you'll need to 
create a Disk Printer. If you do not have a printer setup, you can 
quit the menu and then use the <ba-D> macro to create sucha 
printer. Make sure you do not already have 3 printers defined. 
The macro creates a Text file called “TEMP” on your current 
data disk. This file is automatically deleted after the file is 
reloaded into AppleWorks. 


Note: The printer MUST BE NAMED “DISK PRINTER” — 
anything else and the macro will not continue. 


Number of Columns: 1, 2, or 3. 


You have 3 choices when considering the number of columns. 
Choosing 1 column will simply transfer over the file to a 
formatted ASP file. You then can use the <sa-M> macro to move 
blocks of text to your choice. 


If you choose either 2 or 3 columns, the task file will automati- 
cally format the text into the appropriate columns with the 
appropriate page breaks (see below). When the UP task file is 
done, it returns control to you — allowing you to customize the 
display as you wish. This is useful if you want to place dividers 
between the columns and the like. When you’re done, just press 
Solid Apple-P to print the spreadsheet to the clipboard for your 
AWFP file. 


Lines per Page: 40-88 


This option is used to calculate the page breaks in the ASP file. 
As indicated, it determines the number of lines used per page. A 
3 line blank area follows each page. 


Default Settings 
You can use the Utilities 2.0 to set default values upon entry of 
the Publish Menu application. 


Publish Help 


This application is used by the <sa-/> and< sa-?> macros to 
display a help screen with all the available commands. 


Limitations 
Yes, there are limitations— but most are within reason. 


1. Files on the Desktop 


The task file opens an ASP file on the desktop, thus it 
requires no more than 11 files on the desktop. If you are 
using the Justified Text Option, no more than 10 files on 
the desktop. 


2. Desktop Memory 


Converting an AWP file to multi-column text does 
consume space. The task file will use 5k + Desktop Size 
of file * 2 (3 if you use the Justified Text option). The 5k is 
returned to you after the AWP file is transferred to the 
ASP file. 


3. Too Many Lines 


Because the ASP module in AppleWorks only allows 
999 rows, you are only allowed 990 lines of text in your 
AWP file (when the file is formatted with the 

LM=0.0, RM=6.0). 


4. Justify Option 


In order to use this option, you MUST have a ‘DISK 
PRINTER’ defined (see above). You must also have 
enough room on your current data disk to temporarily 
place a textfile copy of your file. 
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5. Speed 


This is no speed demon, but once it is started, you can 
get a cup of hot chocolate while it does its work. It is 
self running until it has finished formatting the document 
in the ASP. Of course, if you use a IIGS, the UP task file 
will be 2.5 times faster. 


6. Control codes 


Imbedded Control-L and Control-B codes can confuse 
UltraPublisher. Use the option to remove control carets 
and you’ll be safe. 


Despite these limitations, UltraPublisher is very useful and quite 
easy to use. There are only a few commands you need ever type 


from the keyboard. 

<ba-M> will restart the menu driven procedures. 

<ba-D> adds a ‘DISK PRINTER’ printer in 
AppleWorks. 

<sa-M> _ _is used to move blocks of text from one 
column to another. It’s purpose is for 
completely customized layouts. 

<sa-P> will print the current spreadsheet file to the 
Clipboard for transfer back to the AWP 
module. 

<sa-X> will exit the current task file and re-install 
your default macro set. 

<sa-/> 

<sa-?> will use “Publish Help” to display the list 


of commands you can use. 


If you enjoy getting the most out of your macros, be sure you 
examine the code in the UP source file. 


There are a host of little bits of valuable information that you'll 
find if you search through it. Believe me, it’s worth a look. 


Mail Merge 


by Steve Ellis 


Mail.Merge is a special macro set that simplifies using the 
AppleWorks mail merge feature by allowing you to enter 
desired mail merge fields without needing to have the 
information on the clipboard while you work. The macro then 
scans the file and converts the replacement symbols to the 
correct mail merge codes. 


Here’s how fo test Mail Merge: 


1. Add the files “Mail.Merge”, “Mail.Test” and 
“Mail.List” to the Desktop. 

2. Compile “Mail.Merge”. 

3. Copy a record to the clipboard from “Mail.List’”. 

4. Go to “Mail.List” and press Both Apple-M. 

5. An error will be flagged to show how error handling 
works. Change the “13” to “12” and then press 
Both Apple-M again to restart. 

6. The macro will end with all of the proper mail merge 
codes entered. 


Here’s how to create your own Data Base file for 
use with these macros: 


1. Select a Data Base file that you want to use with Mail.Merge. 
A. Select multiple record layout. 
B. Copy one record to clipboard. 
or 
Print to the clipboard for Mail Merge 
(table format only). 
C. Return to Main Menu. 


2. Create a new Word Processor file for your form letter. 
A. Type Open Apple-O, then “MM” and press Return. 
B. Turn your Open Apple-H printer on. 
C. Type Open Apple-H to get a hard copy of MM 
categories with their related numbers. (If you don’t 
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have a printer hooked up, you'll need to write down 
the MM categories and their related numbers.) 
D. Press ESC twice. 


3. You will use this hard copy of MM categories with their 
related numbers when writing your form letter. The “@” 
symbol will be used with the appropriate number instead 
of using the AppleWorks method of entering Mail Merge 
categories. Do NOT add a space between the @ character 
and number. 


Format: @(number) do not use parentheses 
@ by itself is interpreted as @1 
Legal format: @10 or @1 
Illegal format: @ 10or@ 1 


4. Type your form letter, inserting the appropriate @(number) 
where you want a MM category. 

A. Type Open Apple-N and add .M to the end of the file 
name to signify that this is a master form letter. This 
will make revisions very easy. 

B. Save file to disk. 

C. Type Open Apple-N and remove .M from the end 

of the file. 


9. Go to the Data Base file that you are using for Mail.Merge 
categories and copy the records you want to the clipboard in 
multiple record layout or print to the clipboard for MM (table 
format only). (If your printer is not hooked up, you only need 
to copy one record to the clipboard, although you may print to 
the clipboard for MM (table format only). 


6. Compile the file “Mail-Merge” if you have not done so 
already. (You can compile “Mail.Merge” anytime before 
using <ba-M> in form letter.) 


If you have enough room to add the three new tokens to your 
default macro list you can make Mail.Merge available at any 
time. 


Three macros need to be added: <ba-M>, <sa-control-N>, 
<sa-H>. <sa-F> is already in Macros Ultra. If you rename 
keystroke tokens, make sure to change these tokens within 
the macro. 
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7. Go to your form letter file and press Both Apple-M. 


8. Print your form letter(s). (If your printer is not hooked up, 
save your file to disk. Don’t forget to save the finished 
form letter with the .M added to the end of the file name.) 


sample Macros 


Here’s an alphabetical summary of the macro files found on 
MacroTools II: 


AE AufoStart 


Here’s a macro for Applied Engineering Desktop Expander users 
that want the option to reconfigure the AE settings on bootup. It 
also checks for a clock and allows non-clock users to manually 
enter the date. 


Ask Yes No Quest 


This macro allows you to ask the famous “Yes/No” style ques- 
tions from within your macros. Use it to give your macros that 
“professional” touch. 


AWP Printer 


Have you ever wanted to print with slashed 0’s on an 
ImageWriter? You can modify this macro to send any printer 
control codes directly to your printer. 


Disassembler 


Serious UltraMacros hackers often create little 6502 machine 
language routines. This macro program lets you build a routine 
in memory (works great with the IIgs mini-assembler) and then 
it disassembles your program into macro poke statements which 
can then be used as part of any macro set. 


Double DB Macro 


This macro allows you to jump from a record in one Data Base 
file to the same record number (and same layout) in another 
Data Base file on the Desktop. This gives you a poor man’s 60- 
category (or 90 or ...) Data Base. 


Ellis Routines 


These macros by Steve Ellis are handy subroutines that replace 
the UltraMacros <input> and <getstr> tokens with a more 
flexible approach. They allow you to “filter out” unwanted 
keystrokes. 


FileList Macro 
These macros are used with the FileLister TimeOut application 
to create file lists within a macro. The user can then Escape out 


or select a file, with the result being returned in $1 (read “string 
1”, not “one dollar”). 


GetStr Patch 

The <getstr> command can cause Data Base categories to be 
truncated. If you use <getstr> in the Data Base, run this macro 
first. It only needs to be run once each session, because it actually 
patches ULTRA.SYSTEM ina way that can’t be done at startup. 
The <getstr> command will then leave your categories alone. 
llgs Date Time 

If you have a IIgs, this macro set can be used to print the time to 


the nearest second. 


Macro SS Jump 


Spreadsheet power users will love this one! It instantly jumps 
the cursor to the right-most column holding data. 
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Macros AufoEnve 


Here’s the UltraMacros equivalent of the AutoWorks’ address 
envelope macro. 


Macros DateSet 


This macro allows you to manually change the date used by the 
<date> and <date2> commands. If you work past midnight, or 
never leave AppleWorks, this one will come in handy. If you 
have a clock in your Apple, use Reset Date instead. 


MacrosLoad 


TimeOut FileMaster/QuickSpell users can use this macro to load 
a RAM disk with QuickSpell’s dictionary files. It can even be 
made into a task file and started from outside of AppleWorks to 
automate the process. 


Macros ULC 


Here’s a macro set to make a word upper case, lower case, or 
capitalized. The technique can be used to do any “word-based” 
command, such as underlining, boldfacing, etc. 


Misc Munz 


Mark Munz is one of the leading UltraMacros experts; this file 
features some gems from his private collection. One macro 
allows you to easily read the current file name into macro 0, 
another provides a MID$ function, another memorizes your 
location in the Word Processor, while yet another counts all of 
the records currently selected in the Data Base. 


No Keyboard Mac 


True UltraMacros hackers have begged for a way to disable 
some macros so that they can only be used as subroutines, and 
not called from the keyboard. This macro program modifies 
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UltraMacros so that all <ato> macros are “keyboard-disabled”, 
but still callable from other macros. 


Power Startup 


TimeOut 2.0 (and later) users can load multiple TimeOut menus 
at bootup by using this macro. Up to nine different menus can be 
automatically read in. 


Press Space Bar 


Use this macro within your own macro programs to prompt 
users with the common “Press Space Bar to continue” message. 
Combine this with “Ask Yes/No” and your users won't be able 
to tell where AppleWorks stops and UltraMacros starts. 


Printer Chars 


If you want to send printer codes directly to your printer, this 
macro file explains some of the limitations and possibilities. This 
macro shows how ImageWriter bit-mapped graphics can be 
created by UltraMacros. 


RamReset 


Users with Apple’s memory card or the AE RamFactor have 
more problems with TimeOut’s reset protection than they 
should. This patch program increases the chances that they'll be 
able to recover from a Control-Reset. pies 


Reset Date 


UltraMacros users with clocks in their Apples can use this macro 
to update the <date> commands when they work past midnight 
and don’t want to reboot. If you don’t have a clock, use Macros 
DateSet. 
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Safe Save 


Use this macro to properly save files with one keystroke even 
when the “Insufficient room... okay to delete?” message shows 


up. 

screen Shot Src 

If you’ ve ever wanted to capture the AppleWorks text screen to a 
Word Processor file for documenting a program, this macro is 
for you. 

Show Time/Date 

This macro shows the current date and time at the bottom right 
of screen. 

Steal Key 

Macro programmers sometimes want to trap a specific key- 
stroke. This macro intercepts Return and makes it illegal, but 
only in the Word Processor. If you leave the WP, it automatically 
disconnects itself. <call a+34> to disconnect it manually. 

Str Presenter 

If you want a little variety in displaying messages in a macro, 


this one’s for you. The text is displayed within a Word Processor 
file. 


TaskExit Il 


Here’s the proper way to exit complex macro sets. If the users 
have Task Launcher, this will return them to their default 
macros, but if the users do not have Task Launcher, the Macro 
Options Launch Task file method will be used instead. 
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Typewriter 


The TypeWriter macro sends keystrokes directly to your printer. 
This file also includes a macro to count the number of files in a 
directory, and one to display ASCII values which can be used 
with UltraMacros. 


Ulira On/Off 


Fanatical 6502 programmers can use this procedure to deactivate 
and reactivate UltraMacros from within their machine language 
programs. This is necessary if you plan to access any Apple- 
Works routines which read the keyboard. 


Ultra Variables 


This powerful macro allows you to save and load multiple 
UltraMacros variable sets. You'll never be limited to 26 numeric 
and 10 string variables again! 


UpperCASE Str 


Convert an UltraMacros string into all UPPERCASE characters 
with this macro. 


Various Macros 


As the file name indicates, these macros have nothing to do with 
each other. Instant Blanker uses the screen preserver to blank the 
screen in a hurry. Screen Off disables writing to the screen so 
your macros can move through a bunch of menus without the 
user seeing any screen flicker. Invert AppleWorks is for bold 
users who want a change; it makes all of AppleWorks inverse 
text! 
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What is What 


Now that there are two versions of AppleWorks that work with 
UltraMacros, you may need to distinguish between them. Some 
macros also need to determine whether or not PathFinder or 
Late Nite Patches’ Text Loader patch is present on AppleWorks. 
This macro will tell you what is what in AppleWorks. 
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NOTES 


